home *** CD-ROM | disk | FTP | other *** search
/ Megahits 3 / Megahits 3 (1994)(GTI - Rhein-Main-Soft)(DE)[!].iso / module / utilities / powerplayer / powerplayer.doc < prev    next >
Text File  |  1994-10-14  |  28KB  |  715 lines
  1. ==============================================================================
  2.  
  3.             P O W E R P L A Y E R
  4.  
  5.             .....User-Manual.....
  6.  
  7. ==============================================================================
  8.  
  9. PLEASE READ
  10. -----------
  11. PowerPlayer now is SHAREWARE.
  12.  
  13. Why SHAREWARE?  Well, I'm only a poor student and developing good software
  14. has become too expensive for me.  If you want PowerPlayer to continue to
  15. grow and to flourish or if you want to see other great products like
  16. PowerPlayer in the future consider sending 30.- DM to the author.
  17.  
  18. I promise herewith that I won't use your 30.- DM to buy a DAIMLER BENZ.  I
  19. will buy the most current literature available about the AMIGA and it's OS
  20. (do you know how expensive computer literature is?), I will buy the latest
  21. versions of the assemblers and compilers, I will become a registered
  22. developer at CBM and receive important information for future
  23. compatibility, I will write letters to the programmers of other music
  24. software that PowerPlayer doesn't support yet, I will always send the most
  25. current version to big public domain libraries (Fred Fish etc).  And then,
  26. after all - if there's still something left of your 30 DM, maybe I'll buy a
  27. DAIMLER BENZ, though ;-) !
  28.  
  29. I've had the choice to make PowerPlayer SHAREWARE or to make it COMMERCIAL.
  30. I decided to make PowerPlayer SHAREWARE because this is the better
  31. sollution for the user. And I always try to support my users as much as
  32. possible.  All users of PowerPlayer who wrote to me know that I have always
  33. included their ideas in the concept of PowerPlayer and helped everywhere I
  34. could. So, as you can see, I've supported you for long awhile - it's about
  35. time that you help me a little! Think about it!
  36. Thanks in advance
  37.  
  38. Yours Stephan Fuhrmann, author of POWERPLAYER
  39.  
  40. ------------------------------------------------------------------------------
  41.  
  42. The author of this software can't be held liable for the contents of this
  43. package and every damage caused by it.
  44.  
  45.         © 1991-93 STEPHAN FUHRMANN, WEST-GERMANY
  46.  
  47. These freely distributable shared libraries are included in the
  48. PowerPlayer-Package:
  49.  
  50. -ReqTools.Library © by Nico François
  51. -PowerPacker.Library © by Nico François
  52. -Lh.Library © by Holger P.Krekel and Olaf 'Olsen' Barthel
  53.  
  54. Version 3.9 (25 APR 1993)
  55.  
  56. ==============================================================================
  57.  
  58. Greetings (random order)
  59. ------------------------
  60. -Delta/TCC
  61. -Flynn/TRSI for his great NoisePlayer
  62. -Holger P.Krekel & Olaf 'Olsen' Barthel for their lh.library
  63. -Bryan Ford (Mr.Multiplayer)
  64. -Nico François for his _GREAT_ reqtools.library & powerpacker.library and
  65.  his hints concerning the reqtools.library
  66. -Teijo Kinnunen for his routines & 68030 tests
  67. -Steve / Silicon Designs 3003
  68. -Thomas Eibl
  69. -Turbo / Infect
  70. -Wayne Mendoza / Masque !TRSI!
  71. -Bernhard Zahler
  72. -Thomas Ansorge
  73.  
  74. ==============================================================================
  75.  
  76. History
  77. -------
  78. V 1.0:    Version with BUGS & no COOL features :-(
  79. V 1.1:    Removed ALL bugs, added coool CLI-Interface & CLI-InfoPage, PMC
  80. V 1.2:    Added the 4-Channel Oktalyzer-Replay
  81. V 1.3:    Added DeltaMusic (finally got a song :-) ),
  82.     corrected PowerPlayer to recognize SoundMon for ALL Versions,
  83.     optimized ProTracker-Replay
  84. V 1.5:    Added the possibility to start the File-Requester with a specific
  85.     directory, the NoiseTracker 1.3D-Replay has been disabled for a
  86.     strange reason -» FIXED
  87. V 1.6:    In the meantime aged Req.Library has been displaced by the
  88.     ReqTools.Library that generates i.e. nice 3D-Requesters.
  89. V 1.7:    Instead of a VBlank-Interrupt, that replays songs with strange
  90.     speeds when running on Amigas with NTSC or a 10 Hz monitor a
  91.     CIA-Timerinterrupt is used.
  92. V 1.8:    Added the "Restart"-function
  93. V 1.9:    Improved the outputs for faults, the ECLOCK-Frequency will be fetched
  94.     under OS 2.0 from the System, optimized Replays again
  95.     found a bug that exists in ALL tracker-replays, that writes into
  96.     unallocated memory. I don't know whether this bug exists in all
  97.     other Module-Players, too. I recommend to use only PowerPlayer !!!
  98. V 2.0:    Added a replay for TFMX-Modules WITH built-in replay-routine
  99. V 2.1:    Added a replay for MED-Modules
  100. V 2.2:    Now features a GUI (graphical user interface) with a CD-player-like
  101.     button-system. Now uses a big Lh-Buffer for faster decrunching.
  102. V 2.3:    Pressing the right mousebutton will iconify/deiconify the window
  103.     now, the window will be centered beneath the mousepointer when
  104.     launched, new shortcuts were added, code has been optimized
  105. V 2.4:    New functions: First song, last song and random play !
  106. V 2.5:    PowerPlayer will now display a busy-mousepointer when loading &
  107.     decrunching a file and disable the IDCMP of the window.
  108. V 2.6:  PowerPlayer will now look fine on a 2 color-screen
  109. V 2.7:    A little bit more WB 2.0-feeling by adding 3D-Borders
  110. V 2.8:  Included new Protracker-replay (V2.1A), hitting return while
  111.     displaying requesters will activate the negative response
  112.     (for all pessimists ;-)), the PowerPlayer-task is running with
  113.         priority 1, optimized all replays again
  114. V 2.9:    Included Sonix Arranger-replay, new commandline parsing routine +
  115.     commandline flags, multiple modulenames can be specified in the
  116.     commandline
  117. V 3.0:    WorkBench tooltypes for all flags supported (please read the
  118.     chapter "Calling PowerPlayer"), ARexx is supported with many commands
  119.     (please read the chapter "ARexx support"), new "NoReq"-Flag for
  120.         Workbench and CLI (useful for ARexx)
  121. V 3.1:    You may optionally use the filerequester of the asl.library
  122. V 3.2:    SoundMon-Replay now 100% resetable, fixed timing for CPUs
  123.         faster than 68000, now 99.9% safe to use NoisePacker modules,
  124.         new OctaMED pro replay
  125. V 3.3:    New powerful compression, OctaMED 4.0-Replay, Soundmon fixed
  126.     to play samples correctly, new BP-Soundmon type
  127. V 3.4:    Hotkeys, now may used without window, AmigaDOS BREAKable
  128. V 3.5:    Using standard waitpointer, CBM Style Guide conform 3D design,
  129.     PowerPlayer's window is an AppWindow (read the chapter "Calling
  130.     PowerPlayer/WorkBench/AppWindow"), huge pile of new replays,
  131.     new useful ARexx commands, output of the version with '-Ver'
  132. V 3.6:    Now uses ProTracker CIA replay, new great information-requester (?!),
  133.     improved 'awake'-feature (key: 'x'), unimportant 'Bug'-fix of
  134.     CTRL-F
  135. V 3.7:    Uses new improved routine for 'RND', added ProRunner packed replay,
  136.     PMC outputs correct percentages
  137. V 3.8:    The position won't be pasted over the gadgets any longer - PowerPlayer
  138.     will display the percental position instead, you may load and save
  139.     songlists now (in other players they are called 'programs') - read
  140.     "Keyboard Functions" and the "Songlist" chapter, fixed NP 2.0/NP 3.0/
  141.     David Whittaker/Fred/Sonic Arranger-Recognition routines, new Promizer
  142.     replay
  143. V 3.9:    Improved PMC's CLI-interface, UNIC-replay now sounds normal on faster
  144.     AMIGAs, Window repositions correctly on OS 2.0-screens when deiconifying,
  145.     PMC doesn't write to unallocated memory, PowerPlayer restores the
  146.     initial state of the power led when exiting, added a pretty timer,
  147.     removed all ENFORCER hits (I hope), TOOLPRI WB- & CLI-Argument,
  148.     PowerPlayer-Support-Mailbox (no feature, but everybody will notice it here :)
  149.  
  150. ==============================================================================
  151.  
  152. This version of the PowerPlayer supports:
  153.  
  154. David Whittaker
  155. DeltaMusic 1.0 + 2.0
  156. Digital Sound System
  157. Fred
  158. Future Composer 1.0-1.4
  159. Game Music Creator
  160. Jam Cracker
  161. Jochen Hippel            (untested)
  162. Kris
  163. Maniacs Of Noise
  164. Mark II
  165. Morten Grouleff's MusicProgram
  166. Music Assembler
  167. NoisePacker 2.0 + 3.0
  168. NoiseTracker
  169. NoiseTracker 1.3D packed modules
  170. NoiseTracker 1.3D packed modules with replay routine
  171. OctaMED-Modules (MMD0 & MMD1)
  172. Oktalyzer
  173. Promizer I + II
  174. ProRunner packed modules
  175. ProTracker CIA (V2.1a)
  176. SidMon 1.0 and 2.0
  177. Sonic Arranger with replay routine
  178. SoundFX 1.3 + 2.0
  179. SoundMon
  180. SoundTracker 2.6
  181. Startracker 4 voice
  182. Tfmx with replay routine
  183. The Musical Enlightenment
  184. Unic
  185.  
  186. ==============================================================================
  187.  
  188. Installation
  189. ------------
  190. The PowerPlayer NEEDS the PowerPacker.Library and the ReqTools.Library in
  191. your libs:-directory.  The script included in this package will install
  192. them for you.  Optionally the Lh.Library is used.  If you feel fit enough
  193. you can crunch your modules with the powerful PMC which uses the
  194. LH.Library.
  195.  
  196. ==============================================================================
  197.  
  198. Introduction
  199. ------------
  200. Hello and welcome to the world of PowerPlayer!  This fantastic tool was
  201. written in 1991-93 by Stephan Fuhrmann, using the outstanding abilities
  202. of the
  203.  
  204. -ReqTools.Library by Nico François for the File- and Text-Requestors
  205.  
  206. -PowerPacker.Library by Nico François for uncrunching powerpacked files
  207.  
  208. -Lh.Library by Holger P. Krekel and Olaf 'Olsen' Barthel for _BEST_
  209.  compression of modules, executable simple cruncher included.
  210.  
  211. The PowerPlayer is a tool for playing music made with one of the supported
  212. music-programs or compatibles with the good old AMIGA stereo digital
  213. sound-facilities !  There have been many of these programs before, but
  214. PowerPlayer is something different:
  215.  
  216. -cool fast tricky optimized 100% assembly code, most parts PC-Relative
  217. -works on CPU 68000, 68010, 68020, 68030, 68040 and it should work on the 68060
  218.  and all future CPUs
  219. -works with OS 1.3, 2.0, 3.0 without any problems
  220. -little pretty (?) play-window
  221. -maaaany optimized replays
  222. -PowerPacker-Library for using always the latest and fastest decrunch-routine
  223. -supports xpk crunched modules !
  224. -Lh-Library for deepest compression ever seen on modules (try it out !)
  225. -powerful ARexx-Port for remote control of PowerPlayer
  226. -may be used in thousands of ways from WorkBench and from CLI
  227. -allocates its audio-channels with the audio.device
  228. -great support BBS (DOOMSDAY, phone number at the end of this document)
  229.  
  230. But let us start at the beginning:
  231.  
  232. Calling PowerPlayer
  233. -------------------
  234.     WorkBench
  235.     ---------
  236.         DoubleClick
  237.         -----------
  238.             DoubleClick the icon of the PowerPlayer, choose the
  239.             file in the File-Requester, hit 'OK' and enjoy !
  240.         DefaultTool
  241.         -----------
  242.             You have a module with an icon. Select this icon and
  243.             activate the info-function of the Workbench. Now
  244.             select the DefaultTool. Enter the path of
  245.             PowerPlayer and press <RETURN> to terminate the input.
  246.             Press the SAVE-Gadget.
  247.             Now everytime you doubleclick the project-icon
  248.             PowerPlayer will be loaded and will play your song !
  249.         MultiSelect
  250.         -----------
  251.             Move the mousepointer over the PowerPlayer-Icon and
  252.             press the left mousebutton ONCE. Now press SHIFT and
  253.             leave it pressed. Select the songs you want to hear
  254.             with the mouse. Now doubleclick the last song and
  255.             release SHIFT. Your songs will be loaded !
  256.  
  257.         ToolTypes
  258.         ---------
  259.                         Place the mousepointer over the powerplayer-icon
  260.             and activate it by choosing "Info" out of the
  261.             Workbench-menus. You have got the possibility
  262.             to add/change the following ToolTypes:
  263.                         QUALIFIER=(qualifier for hotkeys)
  264.                 This specifies the qualifier you want for
  265.                 the hotkeys
  266.                         DIRECTORY=(directory you want in the filerequester)
  267.                 This specifies the directory that will be
  268.                 displayed first in the filerequester
  269.                 Example: DIRECTORY=DF0:Modules
  270.             PATTERN=(pattern you want in the filerequester)
  271.                 This specifies the pattern all files in
  272.                 the filerequester are matched with
  273.                 Example: PATTERN=MOD.#?
  274.             LED=[0|1|M]
  275.                                 This specifies the mode of the filter-LED:
  276.                 0=Force filter-led off
  277.                 1=Force filter-led on
  278.                                 M=Let the module decide (default)
  279.                 Example: LED=0
  280.             NOREQ=[TRUE|FALSE]
  281.                 Tells PowerPlayer to pop up *NO* filerequester
  282.                                 if it started without any files specified.
  283.                 Useful for ARexx since you can't control
  284.                 Nico's Filrequester with ARexx ;-).
  285.                         NOWIN=[TRUE|FALSE]
  286.                 Tells PowerPlayer to open *NO* window
  287.                 on startup.
  288.             ASL=[TRUE|FALSE]
  289.                 Tells PowerPlayer to use the filerequester
  290.                 of the asl.library. You need OS 2.0 to do
  291.                 this. If PowerPlayer failed to open the
  292.                 library or the requester the reqtools-
  293.                 requester will be used.
  294.             NOTIMER=[TRUE|FALSE]
  295.                 Tells PowerPlayer that you do/don't want
  296.                 to have a timer. The timer tends to need
  297.                 some CPU cycles once a second.
  298.             TOOLPRI=[-128..127]
  299.                 Sets the task priority of PowerPlayer to the
  300.                 specified value. DANGER! Stay in the range
  301.                 from -3 to +3, otherwise you will disturb
  302.                 important system tasks!
  303.  
  304.         AppWindow
  305.         ---------
  306.         (WB 2.0+ only)
  307.             Additional to the possibility to use awkward
  308.             filerequesters, it is possible to drag icons of modules
  309.             directly into PowerPlayer's window! PowerPlayer will
  310.             load and play all modules dropped into
  311.             its window at once.
  312.     CLI/Shell
  313.     ---------
  314.         Filerequester
  315.         -------------
  316.             Everyone knows how to handle filerequesters, so I
  317.             do not want to explain the very sophisticated one
  318.             of the reqtools.library. Type the name of PowerPlayer
  319.             in the CLI/Shell you have opened and add the
  320.             parameter '-r' to the command. You will see
  321.             a filerequester where you can select your songs.
  322.                         This flag is obsolete, PowerPlayer will pop up
  323.                         the filerequester if there are no files specified
  324.             on startup.
  325.             Example: PowerPlayer -r
  326.         Filename
  327.         --------
  328.             If you do not want to select the file by making use
  329.             of the filerequester (i.e. in scripts) you may also
  330.             add one or multipe modulenames with its/their path
  331.             to the commandline.
  332.             Example: PowerPlayer df0:MOD.PowerTheme ram:SID.Mega
  333.  
  334.         Information
  335.         -----------
  336.             If you want to see the cool information-page,
  337.             enter: PowerPlayer ?
  338.         Version
  339.         -------
  340.             If you want to find out the version of PowerPlayer,
  341.             simply enter:
  342.             PowerPlayer -Ver
  343.         Flags
  344.         -----
  345.             There are multiple flags that can make the time
  346.             you pass using the PowerPlayer more convenient:
  347.             -r........use filerequester (obsolete)
  348.             -nr.......don't pop up filerequester at start when
  349.                     there are no files specified
  350.                         -nw.......don't open a window at start
  351.             -dDIR.....set the directory of the filerequester
  352.                     i.e. '-dDF0:modules'.
  353.             -pPAT.....set the pattern of the filerequester
  354.                     i.e. '-pMOD#?'.
  355.             -qQUAL....set the qualifier for the hotkeys
  356.                     (see hotkey-chapter)
  357.             -l0/1/M...set the mode of the filter-led.
  358.                     0=force filter off
  359.                     1=force filter on
  360.                     M=module controls filter
  361.             -ASL......Tells PowerPlayer to use the filerequester
  362.                     of the asl.library. You need OS 2.0
  363.                     to do this. If PowerPlayer failed to
  364.                     open the library or the requester the
  365.                     reqtools-requester will be used.
  366.             -nt.....Tells PowerPlayer to use _NO_ timer.
  367.                 The timer tends to need
  368.                 some CPU cycles once a second. Default
  369.                 is timer on.
  370.             -ToolPri=[-128..127]..sets the task priority of
  371.                 PowerPlayer to the specified value. DANGER!
  372.                 Stay in the range from -3 to +3, otherwise
  373.                 you will disturb important system tasks !
  374.  
  375.  
  376. Play-Requester
  377. --------------
  378. The Play-Requester contains information about the module and some gadgets.
  379. If you start PowerPlayer without a window (NOWIN) and have specified a
  380. qualifier for hotkeys you are able to open the window by pressing qualifier
  381. and 'w'.
  382.  
  383. Questionmark....displays the usual information concerning copyright &
  384.         features.
  385. Eject...........ejects the current list of songs & asks you with a
  386.         filerequester for a new one.
  387. FirstSong.......will load & play the first song from the list.
  388. PrevSong........will load & play the previous song from the list.
  389. Play............will play the song. Will automatically unpause, if you
  390.         hammer the PLAY again the song will start from the
  391.         beginning.
  392. FastForward.....will play the song twice as fast as normal. This gives a
  393.         nice FF-effect ! Rehammer will switch back to normal speed.
  394. NextSong........will load & play the next song from the list.
  395. LastSong........will load & play the last song from the list.
  396. Stop............will stop the song. Automatically unpauses, unFFs and
  397.         unplays!
  398. Pause...........stops the song until you repress pause or push play.
  399. Reset...........will start the song again.
  400. RND.............will load & play a randomly chosen song.
  401.  
  402. For further information about the keyboard functions of Powerplayer read the
  403. Chapter 'Keyboard Functions'.
  404.  
  405. Pressing the right mousebutton will change to the iconify-mode. The window
  406. will shrink to a minimum height of 10 pixels. The gadgets will disappear,
  407. but you can still control PowerPlayer with the keyboard-shortcuts.
  408. To unshrink the window to its normal size you just have to hit the
  409. right mousebutton again.
  410.  
  411. The display of the window contains
  412. -the name of the module (top of window)
  413. -type of the module & length of the module in bytes (middle of window)
  414. -the gadgets and the position-indicator that displays your position in the
  415.  file-list.
  416.  
  417. My GUI works with a recolor-routine that can handle crazy palettes in a clever
  418. way. It searches for the brightest and darkest colors for the shadows and
  419. it searches for the color with the biggest contrast to the background for
  420. text-output.
  421.  
  422. Songlist
  423. --------
  424. Songlists are a replacement for the torture of selecting ever and ever
  425. the same files with the filerequester. Songlists contain the information
  426. that PowerPlayer usually gets from the filerequester.
  427.  
  428. FOR SAVING SONGLISTS YOU REQUIRE AMIGAOS 2.0 OR HIGHER.
  429.  
  430. Songlists are loaded like songs. You may load a songlist with the
  431. filerequester, you may load it by multiselecting it with PowerPlayer from
  432. the Workbench etc. If a songlist is being loaded PowerPlayer will act as if
  433. you just selected the files with the filerequester: it'll read the first
  434. song and play it.
  435.  
  436. You may save a songlist at every time you want to. Press '#' and a
  437. filerequester will appear and ask you for the name of the songlist you
  438. wish to save. Because of technical reasons the whole path of a song
  439. will be saved. This means that you can use a songlist only for one
  440. volume (disk/harddrive), the volume name will be used in the path.
  441.  
  442. Since songlists are loaded like songs, it is free to you to crunch them.
  443.  
  444.  
  445. Keyboard Functions
  446. ------------------
  447. PowerPlayer offers for advanced users shortcuts and hotkeys which enable you
  448. to control PowerPlayer much better than with gadgets. An additional feature
  449. are the hotkeys. You have got to use the normal keymapping for hotkeys, but
  450. read this later on.
  451.  
  452. Key            Function
  453. .............................................................................
  454. '#'            Save current songlist. A filerequester will appear,
  455.             choose the songlistfile to save. Saving the
  456.             songlist will take a little while, but loading the
  457.             songlist is as fast as usual.
  458. CTRL-F            Puts the PowerPlayer window to the front and unshrinks
  459.             it. Better: 'x'.
  460. 'x' & 'X'        Puts the Workbench and the PowerPlayer window to the
  461.             foreground, and unshrinks it. Better than CTRL-F,
  462.             CTRL-F was left in the code to reach downwards-
  463.             compatibility of the keyboard control.
  464.             CTRL-F couldn't be used as a hotkey, but 'x' can.
  465. ESC / CTRL-C        Quits PowerPlayer
  466. RETURN            loads & plays the next song
  467. '-', '[', '(', '{', '3' loads & plays the previous song
  468. '+', ']', ')', '}', '6' loads & plays the next song
  469. 'e', 'E', '2'        works like the 'Eject' gadget
  470. 'p', 'P', '4'        works like the 'Play' gadget
  471. 'f', 'F', '5'        works like the 'FastForward' gadget
  472. 's', 'S', '7'        works like the 'Stop' gadget
  473. 'r' & 'R','9'        works like the 'Reset' gadget
  474. ' ' & '*','8'        works like the 'Pause' gadget
  475. 'i' & '1'        displays the information-requester
  476. '~', '/'        works like the 'RND' gadget
  477. 'w' & 'W'        opens the PowerPlayer window, if it isn't open yet
  478.  
  479. Hotkeys
  480. -------
  481. Hotkeys enable you to use PowerPlayers standard set of keys -
  482. no matter what the active window or screen is. This means that you can
  483. control PowerPlayer from your wordprocessor without leaving the
  484. wordprocessors screen/window.
  485.  
  486. This feature is turned on by the QUALIFIER ToolType or by the -q flag.
  487. Valid qualifiers are:
  488.  
  489. LSHIFT/LEFT_SHIFT
  490. RSHIFT/RIGHT_SHIFT
  491. CAPSLOCK
  492. CONTROL
  493. LALT/LEFT_ALT
  494. RALT/RIGHT_ALT
  495. LCOMMAND/LEFT_COMMAND/LAMIGA/LEFT_AMIGA
  496. RCOMMAND/RIGHT_COMMAND/RAMIGA/RIGHT_AMIGA
  497.  
  498. To mix these qualifiers you have to seperate the qualifiers with a '!' or
  499. a '|':
  500.  
  501. CONTROL!LSHIFT!LALT
  502.  
  503. This is the recommended standard qualifier that is preset in PowerPlayers
  504. ToolType.
  505.  
  506. ==============================================================================
  507.  
  508. ARexx support
  509. -------------
  510. PowerPlayer offers an ARexx-Port named "PowerPlayer.REXX".
  511.  
  512. The ARexx-Port supports the following commands:
  513.  
  514. PlEject             acts exactly like the "Eject"-button
  515. PlFirst             acts exactly like the "First"-button
  516. PlPrevious          acts exactly like the "Previous"-button
  517. PlPlay            acts exactly like the "Play"-button
  518. PlFF            acts exactly like the "FF"-button
  519. PlNext            acts exactly like the "Next"-button
  520. PlLast            acts exactly like the "Last"-button
  521. PlStop            acts exactly like the "Stop"-button
  522. PlPause            acts exactly like the "Pause"-button
  523. PlReset            acts exactly like the "Reset"-button
  524. PlRnd            acts exactly like the "Rnd"-button
  525. PlQuit            tells PowerPlayer to quit. Don't try to access the
  526.                         ARexx-Port after this command!
  527. PlLoad "<ModName>"    loads <ModName> and plays it.
  528. PlName            returns the name of the current module
  529. PlLength        returns the length of the current module
  530. PlType            returns the type of the current module
  531. PlListPos        returns the current position in the filelist
  532. PlListLen        returns the length of the current filelist
  533. PlMemPlay <HexAdr> <DecSize> <DecMemFreeSize>
  534.             plays the module that can be found at <HexAdr>
  535.             in the memory with the size of <DecSize>
  536.             bytes. <DecMemFreeSize> bytes will be freed
  537.             at <HexAdr> after the module has been replayed.
  538.             A <DecMemFreeSize> of 0 signals that PowerPlayer
  539.             mustn't free the memory area.
  540. ==============================================================================
  541.  
  542. The PowerPlayer Music Cruncher
  543. ------------------------------
  544. PMC has been developed to crunch modules only and I think that it does its
  545. job very good. It beats the compression-ratio of _EVERY_ known cruncher/archiver
  546. on the AMIGA and it is very fast when crunching & decrunching.
  547.  
  548. I have developed the new "SFCD" (Stephan Fuhrmanns Compact Density) mode
  549. which is based upon the old "SFHD" (Stephan Fuhrmanns High Density) mode.
  550. To crunch/decrunch "SFCD"/"SFHD" type modules you require Lh.Library v1.8+.
  551.  
  552. MOD.TEST    |UNCRUNCHED    |SFCD    |SFHD    |POWERPACKER
  553. ----------------+---------------+-------+-------+-----------
  554. SIZE (bytes)    |320044        |189734    |210540    |237832
  555. SUCCESS        |00%        |40%    |34%    |25%
  556. CRUNCHTIME    |0:00        |2:37    |2:47    |2:58
  557. DECRUNCHTIME    |0:00        |0:17    |0:17    |0:07
  558.  
  559. Using PMC is rather simple:
  560.  
  561. PMC [SOURCENAME] [DESTNAME]
  562.  
  563. PMC will load [SOURCENAME], crunch it (or decrunch, if already crunched)
  564. and save it as [DESTNAME].
  565.  
  566. Another possibility is to specify only one filename. PMC will read the
  567. file you specified, crunch/decrunch it and will overwrite the old file:
  568.  
  569. PMC [FILENAME]
  570.  
  571. With this method PMC is able to work with CBM's SPat.
  572.  
  573. PMC writes "SFCD" type modules only, but it can read & decrunch "SFCD" and
  574. "SFHD" type modules.
  575.  
  576. PowerPlayer reads & decrunches "SFCD" & "SFHD" type modules automatically
  577. if the Lh.Library is in your Libs: directory.
  578.  
  579. I have seen some guys loading up modules on BBSs in the PMC-format.
  580. PLEASE use '.PMC' as suffix and note that they need PowerPlayer to replay.
  581. AND check the BBS wether there's PowerPlayer existing or not, they
  582. won't be very happy if they download the stuff and don't find the
  583. PowerPlayer !
  584.  
  585. An example BBS-entry could look like this:
  586. SONG.PMC    Very good module, use PowerPlayer to replay
  587.  
  588. I recommend uploading the modules in the PMC-format without unimportant
  589. 'trash' in an archive. You don't have to decrunch manually, the file
  590. needs less diskspace (it's still crunched) and there's last but not least
  591. the PMC-format that has been developed ONLY for the PowerPlayer, so you
  592. _NEED_ the PowerPlayer to decrunch ß-} !  By doing this you can show your
  593. consent to the PowerPlayer!
  594.  
  595. ==============================================================================
  596.  
  597. Technical Information
  598. ---------------------
  599. PowerPlayer won't create his own process.  It seems to be a modern feature
  600. to launch everything in the background, but I wanted to give the user the
  601. possibility to stop the computer i.e.  in the startup-sequence as long as
  602. the song plays.  I think this is the best way to realize this, if you want
  603. to create a background process for PowerPlayer you will have to "RunBack"
  604. it yourself !
  605.  
  606. If you examine songlists saved by PowerPlayer you'll notice that PowerPlayer
  607. stores the whole path of a file. This may fatten the songlists a little bit,
  608. but it is nessesary for WB & AppWindow filemodes.
  609.  
  610. ==============================================================================
  611.  
  612. Since there are sooo many music-proggies for the AMIGA, it is impossible to
  613. include all the existing replays.  To give you and me the possibility to
  614. expand PowerPlayer to the best moduleplayer ever written, I will built in
  615. any replay-routine sent to me, if the following work is done:
  616.  
  617. -Sourcecode of the Music-Routine in ASSEMBLY, PC-Relative if possible.
  618.  At this time I can only include replayers at the base of the
  619.  verticalblank-interrupt. The sourcecode has to be on a 3.5"-disk
  620. -Add a description how to recognize that certain kind of module or other-
  621.  wise simply enclose 3 or more of those modules and I'll find out myself
  622. -In any case,though, I would like you to add 3 or more Songs that can be
  623.  played with your replay, if possible. I have to test the routines, and
  624.  a music-proggy with less than 3 adequate songs is surely not very useful.
  625. -If the disk has only ONE error, I'll take for granted that you do not want
  626.  it back and shred it. So do use high-quality-disks formatted carefully
  627.  before using (verify) !
  628.  
  629.  
  630. SHAREWARE-INFORMATION: Only registered users receive an update for 5 DM. One
  631. update is automatically provided if you pay the 30 DM shareware fee.
  632.  
  633. If you want some cool features added to the PowerPlayer, do this:
  634.  
  635. -Write a detailed letter with all new features you think of
  636. -If you would like to have the new version include a disk for PowerPlayer
  637.  and 5 DM (DEUTSCH MARK) for my working on it !
  638.  
  639. If you want an update, do this:
  640. -Include a disk for PowerPlayer and 5 DM (DEUTSCH MARK) for all the work
  641.  (envelope, stamps...) !
  642. -I will send you the actual version of PowerPlayer
  643.  
  644. If you just want to write to an AMIGA programmer
  645. -do it!
  646.  
  647. My Address:    Stephan Fuhrmann
  648.         Erikstr. 30
  649.         W-2380 Schleswig
  650.         Germany
  651.  
  652. Always add the version of the PowerPlayer you are using and where you got
  653. it from!
  654.  
  655. ==============================================================================
  656.  
  657. Official PowerPlayer support BBS
  658. ================================
  659.  
  660. DOOMSDAY BBS, GERMANY
  661. ---------------------
  662.  
  663. Sysop    * Stiff! *
  664. CoSysop * Matthias *
  665.  
  666. Port 00  +49 - (0)4621 - 36796 .... Online: 24 H
  667. Port 01  +49 - (0)4621 - 36742 .... Online: 22-8 o'clock
  668.  
  669. PD-Stuff, latest Fish and more!
  670.  
  671. You'll find the most current PowerPlayer version and a special PowerPlayer
  672. board in this BBS.  For questions, ideas, bug-reports & other stuff
  673. concerning the PowerPlayer simply contact the cosysop, he'll inform me of
  674. the stuff.
  675.  
  676. If enough people register I'll buy a modem, so you can contact me direcly
  677. via this BBS.
  678.  
  679. ==============================================================================
  680.  
  681. If you want a great music editor, consider buying
  682.  
  683.         Teijo Kinnunen's OctaMED
  684.  
  685. It has 4 up to 8 Voices, a superb pattern editor, easy to create
  686. synthesizer-sounds, works perfectly in the AMIGA multitasking environment,
  687. has MIDI-support, can handle powerpacked files and much more.
  688.  
  689. Order OctaMED:
  690.     AmigaNuts United
  691.     169, Dale Valley Road
  692.     Hollybrook
  693.     Southampton
  694.     SO1 6QX
  695.     ENGLAND
  696.  
  697. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  698.  
  699. If you want cheap Public Domain disks and more:
  700.  
  701.     H.O.Soft
  702.     H.Ottow
  703.     Postfach 1545
  704.     W-2380 Schleswig
  705.  
  706.     Tel.: (0)4622 499
  707.     (Hotline: Monday, Wednesday, Friday, 19.00-21.00 CET)
  708.  
  709.     Order the 4 Catalog Disks:
  710.         15.- DM (when you're sending an Eurocheque)
  711.         18.- DM (cash on delivery)
  712.  
  713. ==============================================================================
  714. (EOF)
  715.